home *** CD-ROM | disk | FTP | other *** search
/ Pro Artisan 2 / Pro Artisan 2.iso / xdemos / perform / _perf_info next >
Text File  |  1993-11-16  |  9KB  |  218 lines
  1. ###############################################################################
  2. # The Perform application is the copyright of JO Linton and Clares Micro      #
  3. # Supplies 1991. It may be supplied to other users for personal use provided  #
  4. # that this documentation is not deleted. It may not be sold or supplied      #
  5. # commercially without permission from Clares (0606 48511).                   #
  6. ###############################################################################
  7.  
  8.  
  9. !Perform
  10.  
  11. When you have built up a library of scores, you may wish to play a number of 
  12. them in sequence eg as movements of a sonata or tracks in an album. This can
  13. be  done using the application Perform which will play up to 12 Rhapsody or
  14. MIDI  files in sequence. Perform will also play samples such as those
  15. produced by  Armadeus. If you have a sampling board, you could announce each
  16. track before  it is played using this feature!
  17.  
  18. To hear the demonstration scores on this disc to best effect, either plug a
  19. pair of stereo headphones into the socket in the back of the computer or,
  20. better still, obtain a suitable lead and plug it into your HiFi. (You will
  21. probably need a lead with 1 3.5 mm stereo jack on one end and a pair of
  22. phono plugs on the other.)
  23.  
  24. In addition, Perform can load voice modules. This solves the problem of
  25. having  to have the right voices loaded before Rhapsody will play correctly.
  26.  
  27. All this is achieved by setting up a 'Programme' (ie a concert programme,
  28. not a  computer program!) which can be saved as a special file and reloaded
  29. at any  time. Items on the programme can easily be added, deleted and moved
  30. around. The programme may then be played either once through or
  31. continuously, and  because Perform is a standard multi-tasking application,
  32. other RISC OS applications may be run at the same time.
  33.  
  34. Starting and quitting Perform
  35.  
  36. Perform is a standard RISC OS application and is loaded by double clicking
  37. on  its icon in the usual way.
  38.  
  39. Clicking with the Menu button on the iconbar icon leads to the iconbar
  40. menu...
  41.  
  42. Info 
  43. ==== 
  44.  
  45. The first item on the menu gives access to some information about the
  46. program.
  47.  
  48. Play
  49. ====
  50.  
  51. The second ('Play') is shaded because there is no current programme
  52. available. 
  53.  
  54. Panel
  55. =====
  56.  
  57. The third choice opens a small panel which provides you with 5
  58. 'tape-recorder'  style icons including play, pause, stop etc.
  59.      
  60. Quit
  61. ====
  62.  
  63. Choosing the 'Quit' option, by clicking on it with the Select button, stops
  64. any  playing that may be in progress and quits the program.
  65.  
  66. Setting up a programme
  67. ====================== 
  68.  
  69. To set up a completely new programme, click on the iconbar icon using the 
  70. Select button. This opens the main programme window. Alternatively, if you 
  71. have opened the panel, you can open the programme window by clicking on the 
  72. Perform icon in the far left of the Panel window.
  73.  
  74. Each piece on the programme has two (initially blank) boxes, the second of 
  75. which holds the filename of the piece to be played. To fill in this field,
  76. open one  or more directory displays which contain the scores you wish to
  77. play and 'drag'  the file icon into the appropriate box using the Select
  78. button. When you release  the mouse button the file name appears in the box
  79. and its small filetype icon  appears on the right.
  80.  
  81. (Note that although only the leaf name shows in the box, the full filename
  82. is held  by the programme. If the programme and its files are held on the
  83. same disc then  the names are stored relatively. In this case, if you copy
  84. the programme and files  to another disc and maintain the same relationship
  85. between the files then the  programme will run. If the files are not stored
  86. on the same disc as the  programme then the full pathnames, including filing
  87. system and disc names, are  stored. This means that you can construct
  88. programmes with pieces from any  combination of hard and floppy discs, with
  89. the proviso that the score must be  available when it is needed by the
  90. program. However, if you move any of the  files the programme will be unable
  91. to find them. Note that dragging a file icon  into the programme box does
  92. not load the selected file. This happens later, only  when it is needed.)
  93.  
  94. To rearrange the order of pieces, use the same technique - ie 'drag' the
  95. filename  from one box to another. If you use the Select button, the
  96. filename is moved  from one box to the other. If you use the Adjust button,
  97. the filename is copied,  leaving the original in place. Note that if you
  98. drag a filename onto a box which  already has a name, that name is
  99. overwritten.
  100.  
  101. To delete a piece, 'drag' the filename onto the 'bin' icon at the top of the
  102. window.
  103.  
  104. While you are constructing your program, you will notice that the first box 
  105. always contains a tick. This means that this piece is automatically flagged
  106. for  playing. If you want a performance to omit a certain piece (but not to
  107. delete it  from the programme entirely) toggle the tick on and off using the
  108. Select button.  The 'loudspeaker' icon is non functional, it is a reminder
  109. of what this tick means.
  110.  
  111. Perform recognizes four types of file object:
  112.  
  113. 1) Rhapsody 2 & 3files (filetype &C00) 
  114. 2) Midi files (filetype &FD4)
  115. 3) Sample files (filetype &D3C) - (signed linear format)
  116. 4) Programme files (filetype &CB9)
  117.  
  118. In the last case, Perform will load and perform a whole new programme. 
  119. Effectively this means that Perform can perform an unlimited sequence of
  120. pieces  with, if you like, announcements in between!
  121.  
  122. Perform also accepts any other file and when its turn comes round it is
  123. *RUN.  This means that it can load new voices and execute obey files etc.
  124. For example,  if you need to load a voice module called OrchLib before a
  125. piece, simply include  the file in the list at the appropriate place. You
  126. can also drag the !Voices application form Rhapsody II into Perform and it
  127. will load the voices in the directory.
  128.  
  129. If you need to load several voice  modules at once, a more efficient way
  130. would be to list them all in an obey file,  and then include the name of the
  131. obey file in the programme.
  132.  
  133. Since Rhapsody version 1.20 (and above) now recognises voices by name rather
  134. than by  number, it does not matter in what order the voices are loaded. On
  135. the other  hand, you cannot load more than 32 voices at once. It is for this
  136. reason that the  !Perform directory contains a short utility called
  137. 'NoVoices' which removes all  the voices from 10 to 32 (ie it leaves the
  138. default voices of WaveSynth, StringLib  and Percussion intact). It is a good
  139. idea to include this utility at the head of any  programme or obey file
  140. which loads any new voices.
  141.  
  142. Saving a programme 
  143. ==================
  144.  
  145. Click with the Menu button anywhere on the main programme window to open 
  146. the main menu.
  147.  
  148. Save
  149. ====
  150.  
  151. Moving over the save option leads to the Save window...
  152.  
  153.  
  154. You can save your programme in the usual way either by entering a full 
  155. pathname and clicking on the OK icon or by dragging the file icon into a 
  156. directory viewer.
  157.  
  158. Options
  159. ======= 
  160.  
  161. Before choosing the play option on the main menu, check the available
  162. options  by moving over the options item to the Options menu.
  163.  
  164.  
  165. Most of these are the same as in Rhapsody. The only one which is different
  166. is  'Continuous'. When this option is ticked, the programme repeats
  167. continuously.  Do not confuse this with the 'Repeats' option which enables
  168. repeated sections  within a piece to be played, or not as the case may be.
  169.  
  170. Options are saved along with the programme.
  171.  
  172. Play
  173. ====
  174.  
  175. When the options are set correctly, choose 'Play' from the main menu and
  176. away  you go. Note that MIDI files can only be played on a MIDI instrument.
  177. If the  MIDI option is not selected (or if a MIDI interface is not fitted)
  178. then the MIDI  files in the programme are ignored.
  179.  
  180. Skip
  181. ====
  182.  
  183. If, while a programme is being played, you wish to skip to the next item on
  184. the  programme, choose the 'Skip' option.
  185.  
  186. Stop play
  187. =========
  188.  
  189. To stop playing at any time, open the main menu and choose the third item 
  190. which will now say 'Stop play'.
  191.  
  192. When appropriate, the 'Play' and 'Stop play' options appear in the iconbar
  193. menu  as well.
  194.  
  195. The Panel window 
  196. ================
  197.  
  198. You can open the Panel window by choosing the appropriate option on  the
  199. iconbar menu.
  200.  
  201. As has been stated previously, clicking on the Perform icon at the far left
  202. opens  the main programme window. The other icons are, in order from left to
  203. right:
  204.  
  205. 1) Skip back to previous piece
  206. 2) Play from the start
  207. 3) Skip on to the next piece
  208. 4) Stop playing
  209. 5) Pause if playing (toggles on and off)
  210.  
  211. Playing Samples 
  212. ===============
  213.  
  214. Perform will also play sampled sounds. It expects the sample to be in linear 
  215. signed format with the first byte indicating the sample rate in
  216. micro-seconds.  This is the format produced by Armadeus. The expected
  217. filetype is &D3C.
  218.